package com.danciyixue.boot.dcyx.service;

import com.danciyixue.boot.dcyx.model.entity.UserCurrentProgram;
import com.danciyixue.boot.dcyx.model.form.UserCurrentProgramForm;
import com.danciyixue.boot.dcyx.model.query.ProgramsQuery;
import com.danciyixue.boot.dcyx.model.query.UserCurrentProgramQuery;
import com.danciyixue.boot.dcyx.model.vo.CurrentProgramVO;
import com.danciyixue.boot.dcyx.model.vo.ProgramsVO;
import com.danciyixue.boot.dcyx.model.vo.UserCurrentProgramVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 用户当前选择教材项信息服务类
 *
 * @author youlaitech
 * @since 2025-06-22 07:38
 */
public interface UserCurrentProgramService extends IService<UserCurrentProgram> {

    /**
     * 获取用户当前选择教材项信息分页列表
     *
     * @param queryParams 查询参数
     * @return {@link IPage<UserCurrentProgramVO>} 用户当前选择教材项信息分页列表
     */
    IPage<UserCurrentProgramVO> getUserCurrentProgramPage(UserCurrentProgramQuery queryParams);

    /**
     * 获取用户当前选择教材项信息表单数据
     *
     * @param id 用户当前选择教材项信息ID
     * @return 用户当前选择教材项信息表单数据
     */
     UserCurrentProgramForm getUserCurrentProgramFormData(Long id);

    /**
     * 新增用户当前选择教材项信息
     *
     * @param formData 用户当前选择教材项信息表单对象
     * @return 是否新增成功
     */
    boolean saveUserCurrentProgram(UserCurrentProgramForm formData);

    /**
     * 修改用户当前选择教材项信息
     *
     * @param id   用户当前选择教材项信息ID
     * @param formData 用户当前选择教材项信息表单对象
     * @return 是否修改成功
     */
    boolean updateUserCurrentProgram(Long id, UserCurrentProgramForm formData);

    /**
     * 删除用户当前选择教材项信息
     *
     * @param ids 用户当前选择教材项信息ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteUserCurrentPrograms(String ids);

    /**
     * 根据用户ID获取当前选中教材项
     *
     * @param userId 用户ID
     * @return 用户当前选中教材项信息
     */
    UserCurrentProgramVO getCurrentProgramByUserId(Long userId);

    /**
     * 更新用户当前选中教材项
     *
     * @param form 用户当前教材项表单数据
     * @return 是否更新成功
     */
    boolean updateCurrentProgram(UserCurrentProgramForm form);

    /**
     * 根据当前用户Token获取当前教材详细信息
     *
     * @return 当前教材详细信息，包含系列、学期、学习进度等信息
     */
    CurrentProgramVO getCurrentProgramDetailByUserToken();
}
